Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 20 - QuickDraw 3D Mathematical Utilities / QuickDraw 3D Mathematical Utilities Reference

QuickDraw 3D Mathematical Utilities / Setting Up Transformation Matrices

Q3Matrix4x4_SetRotateVectorToVector

You can use the Q3Matrix4x4_SetRotateVectorToVector function to configure a 4-by-4 transformation matrix that rotates objects around the origin in such a way that a transformed vector matches a given vector.

TQ3Matrix4x4 *Q3Matrix4x4_SetRotateVectorToVector (
TQ3Matrix4x4 *matrix4x4, 
const TQ3Vector3D *v1, 
const TQ3Vector3D *v2);

matrix4x4

A 4-by-4 matrix.

v1

A three-dimensional vector.

v2

A three-dimensional vector.

DESCRIPTION

The Q3Matrix4x4_SetRotateVectorToVector function returns, as its function result and in the matrix4x4 parameter, a rotational matrix that rotates objects around the origin in such a way that the transformed vector v1 matches the vector v2. Both v1 and v2 should be normalized.